📊 KPI Principali Visualizzabili

1. Coverage Nazionale:
• 124 Centrali distribuite su 3 macro-aree
• Densità per area: applica filtro Area per valutare bilanciamento
• Identificazione zone sotto-servite

2. Salute Operativa Rete:
• % Collegamenti ATTIVI vs totale
• Collegamenti in fase progettuale (IN_ATTIVAZIONE + IN_VARIAZIONE)
• Collegamenti critici (NON_ATTIVO, IN_REINSTRADAMENTO)

3. Progetti in Corso:
• Filtra per "IN_ATTIVAZIONE" → vedi pipeline nuovi collegamenti
• Filtra per "IN_VARIAZIONE" → vedi upgrade/modifiche
• Filtra per "IN_REINSTRADAMENTO" → vedi ottimizzazioni routing

4. Distanze e Topologia:
• 8.024,40 km totali di fibra/collegamenti
• Usa "Selezione Attuale" per subset di interesse
• Confronta distanze tra scenari alternativi

📊 Analisi Comparativa Multi-Periodo

Obiettivo: Tracciare crescita e evoluzione rete nel tempo
Metodo: Confronta snapshot Rev7.x vs Rev6.x
• Conta nuovi collegamenti aggiunti
• Identifica collegamenti dismessi
• Valuta crescita km fibra totali
• Analizza shift geografico investimenti
Valore: ROI tracking, forecast budget futuro

🔍 Identificazione Colli di Bottiglia

Obiettivo: Trovare single points of failure nella topologia
Metodo:
• Seleziona una zona strategica (es: RM per Lazio)
• Conta quante centrali hanno solo 1-2 collegamenti
• Verifica ridondanza: esistono percorsi alternativi?
• Se centrale ha 1 solo link = SPOF identificato
Azione: Prioritizza investimento in ridondanza

💰 Cost-Benefit Analysis Nuovo Collegamento

Obiettivo: Valutare ROI per proposto nuovo link
Dati Necessari:
• Distanza nuova tratta (usa 📏 sulla mappa)
• Centrali attualmente servite da quella tratta
• Traffic volume potenziale (dato esterno)
Calcolo Rough:
• CAPEX fibra ≈ €20.000-50.000/km (medio)
• Latency risparmiata = (old_distance - new_distance) / 200.000 km/s
Decisione: Se riduzione latency >2ms E traffic >10Gbps → probabile GO

📐 Calcolo Densità di Rete

Formula: Densità = Numero Collegamenti / Numero Centrali
Valore Ideale: 2.5-3.5 (rete ben connessa con ridondanza)
NAT Italia: 330/124 = 2.66 (buona densità)
Uso: Valuta singole zone: se <2.0 = sotto-connessa

🌐 Network Resilience Index

Definizione: % centrali con ≥2 collegamenti
Come Calcolare:
1. Seleziona tutte le centrali
2. Per ognuna, conta collegamenti (visibile in lista)
3. Conta centrali con degree ≥2
4. Resilience = (Centrali con ≥2 link / Totale centrali) × 100
Target: >85% per rete robusta

📡 Struttura Dati Collegamenti

Campi Disponibili per Ogni Link:
• id: Identificativo univoco numerico (integer)
• from / from_id: ID centrale di partenza
• to / to_id: ID centrale di arrivo
• from_name / to_name: Nomi testuali centrali
• distance_km: Distanza in km (float, precisione 2 decimali)
• stato: Enum [ATTIVO, NON_ATTIVO, IN_ATTIVAZIONE, IN_VARIAZIONE, IN_REINSTRADAMENTO]
• zona: Codice zona (string, 2 caratteri)
• regione: Nome esteso regione
• area: Enum [NORD, CENTRO, SUD]
• arco: Segmento di rete (opzionale)
Formato Storage: Array JavaScript nativo per performance

📍 Struttura Dati Centrali/Nodi

Campi per Ogni Nodo:
• id: Identificativo univoco (string/integer)
• name: Nome completo centrale
• clli: Common Language Location Identifier (standard ITU-T)
• lat: Latitudine (float, formato Decimal Degrees, 6 decimali)
• lon: Longitudine (float, formato Decimal Degrees, 6 decimali)
• zona: Codice zona regionale
• area: Macro-area di appartenenza
• TipoSede: Classificazione sede (Tipo 1/2/3)
Precisione Coordinate: ±11cm con 6 decimali

🌍 Formula Haversine - Distanza Geodetica

Uso: Calcolo distanza "as the crow flies" tra due punti su sfera
Formula Completa:
a = sin²(Δφ/2) + cos(φ1) × cos(φ2) × sin²(Δλ/2)
c = 2 × atan2(√a, √(1−a))
d = R × c
Dove:
• φ = latitudine (in radianti)
• λ = longitudine (in radianti)
• R = raggio terrestre = 6371 km
• Δφ = φ2 − φ1
• Δλ = λ2 − λ1
Errore: <0.5% per distanze <1000km
Implementazione: Funzione JavaScript nativa nell'applicazione

🚗 OSRM Routing - Distanza Stradale

Engine: Open Source Routing Machine v5.x
Database: OpenStreetMap con update mensili
Algoritmo: Contraction Hierarchies per performance
Query: HTTP GET a endpoint OSRM pubblico
Response Time: <500ms tipico per query EU
Precisione: ±2-5% vs distanze reali misurate
Limitazioni:
• Solo strade carrozzabili (no sentieri, private roads in alcuni casi)
• Route optimization basato su tempo, non shortest path puro
• Può differire da GPS turn-by-turn moderni

📐 Strumento Misura Manuale (Ruler Tool)

Attivazione: Click icona 📏 in barra controlli mappa
Procedura:
1. Tool attivato: cursore cambia in crosshair
2. Click primo punto sulla mappa
3. Appare marker iniziale
4. Click secondo punto
5. Linea rossa tratteggiata collega i punti
6. Popup mostra distanza in km
7. Opzionale: click punti aggiuntivi per polilinea
Cancellazione: Click icona 🗑️ per rimuovere tutte le misure
Precisione: Equivalente a Haversine (±0.5%)
Limiti: No automatic snapping a nodi/link

🎯 Misura Automatica tra Centrali Selezionate

Metodo:
1. Seleziona centrale A nella lista Centrali
2. Seleziona centrale B nella lista Centrali
3. Click collegamento che li unisce (se esiste)
4. Distanza mostrata in popup e in tabella
Alternativa per Centrali Non Direttamente Collegate:
• Usa Ricerca Centrali COLT Vicine da centrale A
• Output include distanza a tutte le centrali limitrofe
• Nessuna se B non è tra le top 3 → usa ruler tool manuale

⚡ Calcolo Latenza Fibra Ottica

Formula Base:
Latency (ms) = (Distance km / Speed km/s) × 1000
Velocità Luce in Fibra:
• Vuoto: c = 299.792 km/s
• Fibra SMF (G.652): v ≈ 200.000 km/s (⅔ c, indice rifrazione n≈1.5)
Esempio:
Distanza ROMA-MILANO ≈ 480 km (aerea)
Latency teorica = 480 / 200.000 × 1000 = 2.4 ms
Latency Reale: +0.5-1ms per commutazione, repeater, connettori
Budget Link: Tipico RTT (Round Trip Time) = latency × 2

📡 Calcolo Attenuazione Fibra

Formula:
Attenuation (dB) = α × Distance (km) + Connectors + Splices
Valori Tipici:
• Fibra SMF G.652 @ 1550nm: α = 0.2-0.25 dB/km
• Connettori: 0.3-0.5 dB ciascuno
• Splice fusion: 0.05-0.1 dB ciascuno
Esempio ROMA-MILANO 480km:
Fibra: 480 × 0.22 = 105.6 dB
Connettori (2): 2 × 0.4 = 0.8 dB
Splice (10 ogni 50km): 10 × 0.08 = 0.8 dB
Totale Link Budget: ~107 dB
Margin: Se Tx=+3dBm, Rx sensitivity=-30dBm → disponibili 33dB → NON sufficiente! → Necessari amplificatori EDFA

🌐 Calcolo Capacità Spettrale DWDM

Canali ITU-T G.694.1 C-band: 80 canali @ 50GHz spacing
Singolo Canale: 100 Gbps tipico (coherent optics)
Capacità Totale Fibra: 80 × 100 = 8 Tbps (8.000 Gbps)
Con Tecnologia Attuale (400G channels):
80 × 400 = 32 Tbps potential
Uso Pratico:
• Calcola quante fibre necessarie per traffic forecast
• Esempio: serve 20 Tbps? → Minimo 3 fibre @ 8Tbps (con margin)

📊 Quick Reference - Conversioni e Costanti

Conversioni Distanza:
• 1 km = 0.621371 miles
• 1 mile = 1.60934 km
Conversioni Coordinate:
• 1 grado latitudine ≈ 111 km
• 1 grado longitudine ≈ 111 km × cos(latitudine)
• 1' (arc minute) ≈ 1.852 km
• 1" (arc second) ≈ 30.9 metri
Costanti Fibra:
• Velocità luce vuoto: 299.792.458 m/s
• Velocità fibra SMF: ~200.000 km/s
• Attenuazione tipica @ 1550nm: 0.22 dB/km
• Dispersione cromatica SMF: ~17 ps/(nm·km)

✅ Checklist Pre-Intervento

1. Localizza la Centrale Target:
• Cerca nome centrale in tabella "Centrali / Nodi"
• Click per visualizzare posizione esatta su mappa
• Verifica coordinate GPS (LAT/LON)
• Copia coordinate per inserimento in navigatore

2. Identifica Collegamenti Coinvolti:
• Filtra tabella Collegamenti per nome centrale
• Nota tutti i link connessi a quella sede
• Verifica quali sono ATTIVI vs quali in lavorazione
• Stampa/salva screenshot per riferimento offline

3. Pianifica Accesso:
• Usa "🏢 Centrali COLT Vicine" inserendo indirizzo di partenza
• Clicca "Mostra percorso" per routing stradale
• Nota distanza e tempo stimato
• Verifica se serve 4x4 per percorsi di montagna

4. Verifica Situazione Locale:
• Zoom su centrale con livello massimo (18)
• Osserva edifici circostanti, strade, accessi
• Identifica parcheggio potenziale
• Screenshot della zona per riferimento

🧭 Navigazione in Tempo Reale

Con Dispositivo Mobile (Tablet/Smartphone):
• Apri NAT Italia nel browser mobile
• Concedi permessi di localizzazione al browser
• La mappa mostra la tua posizione attuale
• Usa "Centrali COLT Vicine" dalla tua posizione live
• Vedi le 3 centrali più prossime in real-time
Offline Fallback:
• Pre-carica pagina NAT Italia quando hai connessione
• Mappa base rimane in cache browser
• Dati centrali sono embedded (no richieste server)
• Funzioni base (zoom, misura) operative offline

🔍 Verifica On-Site

Conferma di Essere nel Posto Giusto:
1. Apri app GPS (es: Google Maps) sul telefono
2. Leggi coordinate attuali
3. Confronta con coordinate centrale in NAT Italia
4. Se match entro 50-100 metri → sei nel posto corretto
5. Se discrepanza >500m → ricontrolla indirizzo
Troubleshooting Posizione Errata:
• Possibile errore dati: segnala a coordinamento
• Usa ricerca indirizzo inversa per verifica
• Chiedi conferma via radio/telefono a control room

📲 Ottimizzazione per Tablet/Smartphone

Performance:
• Chiudi altre app per liberare RAM
• Usa WiFi quando disponibile (più veloce di 4G per OSRM routing)
• Se lento: deseleziona "Mostra Marker Centrali" per ridurre rendering
Batteria:
• Riduci luminosità schermo
• Disattiva GPS quando non necessario
• Chiudi tab browser non usati
Connettività:
• Pre-carica mappa con WiFi prima di partire
• Screenshot delle zone di lavoro per backup offline
• Salva coordinate critiche in note del telefono

🗺️ Integrazione con Altri Tool GPS

Export Coordinate per Nav Externa:
1. Click centrale target in NAT Italia
2. Leggi coordinate LAT/LON dal popup o tabella
3. Copia coordinate
4. Apri Google Maps / Waze / TomTom
5. Incolla coordinate in search bar (formato: 41.9028, 12.4964)
6. App naviga verso quel punto
Formato Universale: Decimal Degrees (DD) funziona su tutte le app
Alternative: Se app richiede DMS, usa convertitore in NAT Italia

❓ Troubleshooting Guide

Problema: "Non Trovo la Centrale X"
• Verifica spelling: usa ricerca parziale (es: "MIL" per Milano)
• Prova con CLLI invece di nome
• Controlla filtri: se Area SUD attivo, centrali NORD sono nascoste
• Reset All e riprova

Problema: "Mappa Non Si Carica"
• Verifica connessione internet (tiles da OpenStreetMap)
• Refresh page (F5 o pull-to-refresh su mobile)
• Clear cache browser
• Prova browser alternativo (Chrome vs Firefox)

Problema: "Coordinate Sembrano Sbagliate"
• Verifica formato: LAT deve essere ~37-47 per Italia
• LON deve essere ~7-18 per Italia
• Se LAT/LON invertiti: swap manualmente
• Se coordinate tipo "N 41° 54' 10"" → convert to DD first

Problema: "Percorso Stradale Non Disponibile"
• OSRM potrebbe essere offline (temporaneo)
• Fallback: usa distanza aerea × 1.3 come stima
• Usa Google Maps routing come alternativa
• Report issue a team sviluppo

Come Usare i Percorsi CRO

1. Esporta da CRO: In CRO Italia, calcola i percorsi e premi "🌍 Mappa NAT"
2. Apri Pannello: In NAT, premi bottone "CRO" sulla mappa
3. Aggiorna: Premi "🔄" per caricare i nuovi percorsi
4. Visualizza: Abilita i percorsi con i toggle nella lista
5. Naviga: Usa "🔍 Zoom" per centrare la mappa su un percorso
6. Dettagli: Premi "📋 Info" per vedere tutti i collegamenti
7. Collegamenti: Premi "📂 Collegamenti" per espandere/comprimere la lista

Tipi di Percorsi

• Blu - Percorsi RA (Rete Aggregation)
• Rosso - Percorsi RC (Rete Core)
• Viola - Percorsi Unificati RA+RC
• 🔀 Multi-Path - Percorsi RA su archi multipli (con hop reali evidenziati)
• STD - Percorsi Standard
• DIV - Percorsi Diversificati (linea tratteggiata)

Stati Disponibili e Uso

• 🟢 ATTIVO - Collegamenti operativi normali. Default: ON
  Quando deselezionare: Per focus solo su problemi/progetti
• 🔴 NON_ATTIVO - Collegamenti disattivati o fuori servizio. Default: ON
  Quando selezionare solo questo: Audit impianti dismessi, verifica asset
• 🟡 IN_ATTIVAZIONE - Collegamenti in fase commissioning. Default: ON
  Quando selezionare solo questo: Monitoring progetti, tracking timeline
• 🟠 IN_VARIAZIONE - Upgrade o modifiche tecniche in corso. Default: ON
  Quando selezionare solo questo: Identificare link a rischio per maintenance window
• 🔵 IN_REINSTRADAMENTO - Migrazione traffico attiva. Default: ON
  Quando selezionare solo questo: Track operazioni di rete ottimization

3 Macro-Aree

• NORD - Include zone: PV, LO, LI, NE, ER
  Copertura: Piemonte, Valle d'Aosta, Lombardia, Liguria, Trentino, Veneto, Friuli, Emilia Romagna
• CENTRO - Include zone: TO, MU, RM, AM
  Copertura: Toscana, Marche, Umbria, Lazio, Abruzzo, Molise
• SUD - Include zone: CB, SA, PU, CA, SI
  Copertura: Campania, Basilicata, Puglia, Calabria, Sicilia, Sardegna

Zone Disponibili (Codici a 2 Lettere)

NORD: PV (Piemonte/VdA) • LO (Lombardia) • LI (Liguria) • NE (Nord-Est) • ER (Emilia Romagna)
CENTRO: TO (Toscana) • MU (Marche/Umbria) • RM (Lazio) • AM (Abruzzo/Molise)
SUD: CB (Campania/Basilicata) • SA (Sardegna) • PU (Puglia) • CA (Calabria) • SI (Sicilia)

Bottoni Veloci

• Tutto: Seleziona istantaneamente tutte le 14 zone
  Uso: Ripristino visibilità completa dopo un filtro specifico
• Azzera: Deseleziona tutte le zone
  Uso: Base per selezione negativa (azzera tutto, poi aggiungi solo quelle volute)

Struttura Archi

Concetto: Gli archi rappresentano raggruppamenti logici di collegamenti per scopo infrastrutturale.
Esempi Tipici:
• Arco_Dorsale_Nord: Collegamenti backbone area settentrionale
• Arco_Anello_RM: Anello metropolitano Roma
• Arco_Interconnessione_EU: Link transfrontalieri
Numero Archi: Variabile (dipende da architettura rete)

Come Usare

1. Espandi lista archi disponibili
2. Seleziona/deseleziona checkbox per arco specifico
3. Solo collegamenti appartenenti ad archi selezionati sono visibili
4. Usa "Tutto"/"Azzera" per controllo rapido
Combinazione con Altri Filtri: Arco + Stato + Area = filtro ultra-specifico

Componenti Tabella

• Contatore: Mostra "X / Y" dove X=selezionati, Y=visibili con filtri attuali
• Campo Ricerca: Filtra in tempo reale per ID, nome centrale, CLLI
• Bottone "X": Pulisce il filtro di ricerca
• Bottone "Tutti": Seleziona tutti i collegamenti visibili; richiede una conferma prima di procedere, poiché la sincronizzazione di mappa e tabella può richiedere alcuni secondi.
• Bottone "Azzera": Azzera la selezione
• Bottone "Select" (Azzurro): Toggle per mostrare SOLO collegamenti selezionati
  Click 1: Mostra solo selezionati • Click 2: Mostra tutti (con filtri applicati)
• Bottone "Copia" (Giallo): Appare quando almeno 1 collegamento è selezionato. Copia negli appunti i dettagli di tutti i collegamenti selezionati in formato testuale.
• Lista Scrollabile: Max altezza 135px, scroll automatico se più elementi

Informazioni per Ogni Collegamento

Linea 1: ID – Centrale A → Centrale B ✓ (se selezionato)
Linea 2: Distanza km • Zona • Regione • Stato
Colorazione Stato:
• Verde = ATTIVO
• Rosso = NON_ATTIVO
• Giallo = IN_ATTIVAZIONE
• Arancione = IN_VARIAZIONE
• Blu = IN_REINSTRADAMENTO

Interazioni

Click su Collegamento: Seleziona/deseleziona + zoom automatico sull'area
Evidenziazione Selezione: Sfondo azzurro + bordo sinistro blu
Ricerca: Digita testo → lista filtra istantaneamente
Ricerca Avanzata (Modalità Blocco): Digita più ID separati da virgola/punto e virgola
Esempio: "105, 157, 203" → mostra solo questi 3 collegamenti

Componenti Tabella

• Contatore: "X / Y" dove X=selezionate, Y=visibili
• Campo Ricerca: Filtra per nome centrale, CLLI, coordinate parziali
• Bottone "X": Pulisce il filtro di ricerca
• Bottone "Tutti": Seleziona tutte le centrali visibili; richiede una conferma prima di procedere.
• Bottone "Azzera": Azzera la selezione
• Bottone "Select" (Azzurro): Toggle per mostrare SOLO centrali selezionate
• Bottone "Copia" (Giallo): Appare quando almeno 1 centrale è selezionata. Copia negli appunti i dettagli.
• Lista Scrollabile: Ordinamento alfabetico automatico per nome

Informazioni per Ogni Centrale

Linea 1: Nome Centrale ✓ (se selezionata)
Linea 2: CLLI • Lat XX.XXXX • Lon YY.YYYY
Evidenziazione: Se selezionata → sfondo rosa + bordo rosso

Interazioni

Click su Centrale: Seleziona/deseleziona + map pan/zoom su quella sede
Zoom Automatico: Livello 10 su centrale selezionata
Evidenziazione Collegamenti: Tutti i link connessi a quella centrale si evidenziano
Ricerca Multipla: Digita parte di nome comune (es: "ROMA") → vedi tutte centrali con "ROMA" nel nome

➕ ➖ Zoom In / Out

Funzione: Incrementa/decrementa livello zoom (1-18)
Equivalente: Scroll wheel mouse / pinch-to-zoom touch
Livelli Utili:
• Zoom 6: Vista Italia completa
• Zoom 10: Regione/provincia
• Zoom 14: Città dettaglio
• Zoom 18: Livello strada singolo edificio

🇮🇹 IT - Reset Vista Italia

Funzione: Torna istantaneamente a vista default
Parametri Reset:
• Centro: LAT 41.887, LON 12.549 (Centro Italia)
• Zoom: Livello 6
Quando Usare: Se ti sei perso in zoom profondo e vuoi tornare a overview nazionale

📏 Strumento Misura

Funzione: Attiva modalità misura distanze
Procedura:
1. Click icona 📏
2. Click primo punto su mappa
3. Click secondo punto
4. Appare linea rossa tratteggiata con distanza
5. Opzionale: continua click per misura multi-segmento
Precisione: Calcolo Haversine (±0.5%)
Unità: Kilometri (km) con 2 decimali

🗑️ Cancella Misure

Funzione: Rimuove tutti i segmenti di misura dalla mappa
Effetto: Istantaneo, non reversibile (no undo)
Nota: Non cancella collegamenti o nodi, solo misure manuali

🎯 Tracker - Centrali COLT Vicine

Funzione: Strumento interattivo per trovare centrali vicine a una posizione
Procedura:
1. Click icona 🎯 per attivare il tracker
2. Click su un punto qualsiasi della mappa
3. Viene posizionato un marker verde primavera (#00ff7f)
4. Pannello mostra le 3 centrali più vicine con distanze
Marker: 💚 Verde Primavera, 24px con bordo nero
Tip: Usa insieme alla geocodifica indirizzo per posizionamento preciso

🗑️ Cancella Marker Tracker

Funzione: Rimuove tutti i marker posizionati dal Tracker
Posizione: Bottone attaccato sotto 🎯 Tracker
Alternativa: Disponibile anche nel pannello Tracker come "🗑️ Cancella Marker"
Nota: Non disattiva il Tracker, solo cancella i marker esistenti

A1 - NODI A1 (POP Nazionali)

Funzione: Mostra/Nascondi i 32 NODI A1 (POP) sulla mappa
NODI A1: Principali punti di interconnessione regionali della rete TIM
Marker: 💎 Ciano (#00ffff), 14px con bordo bianco
Tooltip: Nome, CLLI [NODO A1], Zona, Regione, Coordinate
Badge: Mostra conteggio nodi trovati nel database corrente
Lista: ALESSANDRIA, ANCONA, BARI, BERGAMO, BOLOGNA, BOLZANO, BRESCIA, CAGLIARI, CATANIA, CATANZARO, COMO, FIRENZE, GENOVA, MILANO (×2), MODENA, NAPOLI, NOLA, PADOVA, PALERMO, PERUGIA, PESCARA, PISA, RIMINI, ROMA (×2), VERONA, SAVONA, TARANTO, TORINO, TRIESTE, VENEZIA

CRO - Percorsi CRO Italia

Funzione: Pannello per visualizzare percorsi calcolati da CRO Italia
Attivazione: Click bottone CRO per aprire/chiudere pannello
Badge: Numero percorsi importati da CRO
Pannello:
• 🔄 Aggiorna - Ricarica percorsi da localStorage
• 👁️ Mostra Tutti - Abilita tutti i percorsi su mappa
• 🚫 Nascondi Tutti - Disabilita tutti i percorsi
• 🗑️ Elimina - Rimuove tutti i percorsi importati
Polyline: 🔵 Blu (RA), 🔴 Rosso (RC), 🟣 Viola (Unificato)
DB Auto-Switch: Quando si importano o abilitano percorsi CRO, il database passa automaticamente alla modalità unificata C-FOS

❌ Cancella Tutto dalla Mappa

Funzione: Rimuove TUTTI gli elementi aggiunti manualmente alla mappa
Elementi Rimossi:
• Marker geocodifica (ricerca indirizzo/coordinate)
• Layer centrali vicine (marker cliente + centrali)
• Misure e linee di misura
• Percorsi CRO visualizzati
• Marker tracker
• Selezioni nodi e collegamenti (tutte le selezioni vengono azzerate)
Risultato: Mappa completamente pulita e pronta per nuove operazioni

🔍 Zoom Selezione

Funzione: Auto-zoom su elementi correntemente selezionati
Algoritmo: Calcola bounding box di tutti nodi/link selezionati, poi fit map
Padding: Automatico 50px per evitare elementi ai bordi
Quando Usare: Dopo selezione multipla per focus area
Prerequisito: Almeno 1 collegamento o centrale deve essere selezionato

🗺️ Zoom All

Funzione: Auto-zoom su TUTTI elementi visibili (rispetta filtri)
Differenza vs Zoom Selezione: Ignora selezione, usa visibilità
Esempio Uso:
• Filtri attivi: Area SUD + Stato ATTIVO
• Click "Zoom All"
• Risultato: Mappa si adatta per mostrare tutto il SUD con link attivi
Tip: Combina con filtri per viste personalizzate rapidamente

🔄 Reset All

Funzione: Reset completo interfaccia a stato default
Cosa Viene Resettato:
• ✅ Tutti filtri Stato → tutti ON
• ✅ Tutti filtri Area → tutti ON
• ✅ Tutti filtri Zona → tutti ON
• ✅ Filtro Arco → tutti ON
• ✅ Selezioni collegamenti → tutte OFF
• ✅ Selezioni centrali → tutte OFF
• ✅ Campo ricerca Collegamenti → vuoto
• ✅ Campo ricerca Centrali → vuoto
• ✅ Misure sulla mappa → cancellate
• ✅ Vista mappa → Italia centro zoom 6
• ✅ Marker geocoding → rimosso
• ✅ Percorsi stradali visualizzati → cancellati
⚠️ NON Resettato: Preferenze browser, history, bookmark
Best Practice: Usa Reset All all'inizio di ogni nuova sessione di lavoro

🏠 Ricerca Indirizzo (Forward Geocoding)

Input: Indirizzo testuale (strada, città, CAP, landmark)
Engine: Nominatim (OpenStreetMap)
Procedura:
1. Click campo "Ricerca Indirizzo"
2. Digita indirizzo (es: "Via Roma 10, Milano")
3. Premi Enter o click 🔎
4. Mappa si centra su indirizzo trovato
5. Marker rosso appare sul punto
6. Coordinate nei campi LAT/LON si aggiornano
Tips per Risultati Migliori:
• Includi sempre città: "Piazza Duomo, Milano" meglio di solo "Piazza Duomo"
• Usa CAP per disambiguare: "Via Roma, 20100 Milano"
• Landmark famosi funzionano: "Colosseo Roma", "Torre di Pisa"
Limitazioni:
• Indirizzi molto nuovi potrebbero non essere nel DB OSM
• Zone rurali hanno copertura minore
• Formattazione italiana richiesta (no indirizzi US-style)

🔎 Nessun Risultato? Usa Google Maps!

Funzione: Quando Nominatim non trova risultati, appare il bottone Google Maps. In più è sempre disponibile il bottone "❓" per le istruzioni.

Bottoni disponibili:
• "Google Maps" - Appare solo quando non ci sono risultati. Apre Google Maps E mostra automaticamente le istruzioni
• "❓" - Sempre visibile. Mostra/nasconde le istruzioni per copiare le coordinate

Procedura:
1. Cerca un indirizzo che non viene trovato
2. Clicca il bottone "Google Maps" (stile colorato)
3. Si apre Google Maps con la ricerca + si aprono le istruzioni automaticamente
4. Trova il punto esatto sulla mappa Google
5. Click destro sul punto → le coordinate appaiono in alto
6. Copia le coordinate (es: "41.1234, 14.5678")
7. Torna su NAT e incolla nel campo "Incolla coordinate"
8. Clicca "📍 Applica Coordinate"
→ Risultato: Marker appare sul punto con le coordinate corrette
→ Il pannello istruzioni e il bottone Google Maps si chiudono automaticamente

💡 Tip: Puoi usare il bottone "❓" in qualsiasi momento per vedere le istruzioni, anche senza cercare prima un indirizzo!

📍 Ricerca per Coordinate (Reverse Geocoding)

Input: LAT e LON numerici
Formato: Decimal Degrees (DD) - esempio: 45.4642, 9.1900
Procedura:
1. Click campo LAT
2. Inserisci latitudine (range valido Italia: ~36 to ~47)
3. Click campo LON
4. Inserisci longitudine (range valido Italia: ~6 to ~19)
5. Click ➤ (freccia) o premi Enter
6. Mappa si centra su coordinate
7. Marker rosso appare
Precisione:
• 4 decimali: ±11 metri
• 5 decimali: ±1.1 metri
• 6 decimali: ±11 cm
Validazione:
• LAT fuori range → errore o default a centro Italia
• LON fuori range → errore
• Formato errato (es: lettere) → ignore o default

🌐 Display Coordinate Real-Time

Funzione: Campo "Ricerca Indirizzo" mostra sempre coordinate centro mappa
Aggiornamento: Real-time mentre trascini/panori la mappa
Uso:
• Sposta mappa su punto di interesse
• Leggi coordinate nel campo
• Copia per uso in altri tool (GPS, GIS, etc.)
Formato Display: "LAT: XX.XXXXXX, LON: YY.YYYYYY"

🔢 Algoritmo di Ricerca

Step 1: Calcola distanza Haversine da punto query a tutte le 124 centrali
Step 2: Sort centrali per distanza crescente
Step 3: Prendi top 3
Step 4: Per ogni top 3, query OSRM per routing stradale
Step 5: Display risultati con dual metric (aerea + stradale)
Performance: ~1-2 secondi totali su connessione media
Fallback: Se OSRM fail, mostra solo distanza aerea

📊 Interpretazione Output

Distanza Aerea (Linea Rossa Tratteggiata):
• Rappresenta shortest path "as the crow flies"
• Utile per: calcolo latenza fibra, rough estimate costi
• Limitazione: Ignora ostacoli (montagne, fiumi, proprietà private)

Distanza Stradale (Linea Blu Continua):
• Rappresenta percorso effettivo con strade reali
• Utile per: logistica installazione, tempo viaggio tecnici
• Include: curve, salite, limiti velocità stradali

Rapporto Stradale/Aerea (Indice di Tortuosità):
• <1.2: Percorso quasi rettilineo (ideale)
• 1.2-1.4: Percorso ragionevole (normale)
• 1.4-1.6: Percorso tortuoso (attenzione)
• >1.6: Percorso molto tortuoso (problematico, possibili ostacoli significativi)

📋 Come Usare - Step by Step

Passo 1: Seleziona una Centrale
• Vai alla sezione "🌐 Centrali / Nodi"
• Cerca e clicca sulla centrale di interesse
→ La riga diventa rossa e appare il bottone "📊 Info"

Passo 2: Apri il Pannello Info
• Clicca sul bottone verde "📊 Info" a destra della riga
→ Si apre il pannello con layout 2×4

Passo 3: Analizza i Risultati
• Il pannello mostra 8 card in 2 righe:
Riga 1: ⭐ Selezionata + 🔵 3 Centrali RA (Tipo 1/2) più vicine
Riga 2: 🟣 NODO A1 (stesso Area) + 🔴 3 Centrali RC più vicine

📊 Informazioni per Ogni Card

Dati mostrati:
• Nome centrale e CLLI
• Tipo (RA T1/T2, RC, NODO A1)
• Info collegamento (se esiste): ✅ Id collegamento + distanza
• Oppure: ⚠️ "Nessun collegamento diretto" + distanza linea d'aria

Bottoni per ogni card:
• 🎯 Zoom: Centra mappa sulla centrale
• 📋 Copia CLLI: Copia il codice CLLI negli appunti (feedback visivo: diventa verde "✅ Copiato!")
• 🛣️ Percorso: Disegna percorso stradale (non disponibile per "Selezionata")

🗺️ Funzione Percorso

Cosa fa il bottone "🛣️ Percorso":
• Disegna linea d'aria tratteggiata rossa
• Calcola e disegna percorso stradale blu via OSRM
• Apre automaticamente popup con:
  - Distanza linea d'aria
  - Distanza stradale
  - Info collegamento (se presente)

Colore percorso: Blu (#0000FF) - stesso colore di "Centrali COLT Vicine"

🟣 NODI A1 - Database Integrato

Cosa sono: 32 POP/NODI A1 strategici distribuiti per Area geografica
Funzione: Il pannello mostra automaticamente il NODO A1 più vicino nella stessa Area
Aree coperte: PV, LO, MI, LI, TA, VE, FV, NE, ER, TO, MU, LA, AM, CB, PU, CA, SI, SA
Esempi NODI A1: MILANO BERSAGLIO, ROMA INVIOLATELLA, NAPOLI TUPPUTI, TORINO LANCIA...

🔗 Ricerca Collegamenti

Come funziona:
Per ogni centrale mostrata, il sistema cerca se esiste un collegamento diretto con la centrale selezionata nei database attivi (RC e/o RA).

Se trovato: ✅ Mostra Id collegamento + distanza del link
Se non trovato: ⚠️ Mostra "Nessun collegamento diretto" + distanza linea d'aria

🖱️ Pannello Draggable

Funzione "🔓 Sposta":
• Click su "🔓 Sposta" → diventa "🔒 Blocca"
• Ora puoi trascinare il pannello dalla barra del titolo
• Click su "🔒 Blocca" per fissare la posizione

Posizione default: In basso a sinistra sulla mappa

☑️ Mostra Marker Centrali

Funzione: Toggle visibilità dei marker circolari sulle centrali
Default: ON (marker visibili)
Quando Disattivare:
• Mappa troppo affollata con 124 marker
• Performance lenta (device vecchi)
• Focus solo su collegamenti, non su nodi
Effetto OFF: Centrali spariscono visualmente, ma collegamenti rimangono

☑️ Mostra Collegamenti Non Selezionati

Funzione: Toggle visibilità collegamenti non selezionati
Default: ON (tutti collegamenti visibili)
Quando Disattivare:
• Hai selezionato subset specifico e vuoi focus SOLO su quello
• Ridurre clutter visivo
Effetto OFF: Solo collegamenti selezionati (con ✓) rimangono visibili
Combinazione Potente: OFF + "Select" nella tabella = vista ultra-pulita

☑️ Evidenzia Nodi Connessi

Funzione: Quando selezioni collegamenti, evidenzia automaticamente nodi terminali
Default: Dipende da implementazione (solitamente ON)
Effetto ON: Centrali agli estremi di link selezionati cambiano colore/dimensione
Uso: Visualizzazione rapida topologia: quali nodi sono hub critici
Nota: Non seleziona i nodi nella tabella Centrali, solo evidenziazione visiva
✅ Fix 05/12/2025: Ora funziona correttamente con il database C-FOS

Informazioni Visualizzate

Formato DD (Decimal Degrees):
• Lat: XX.XXXXXX°
• Lon: YY.YYYYYY°
Formato DMS (Degrees Minutes Seconds):
• Lat: XX° YY' ZZ" N/S
• Lon: XX° YY' ZZ" E/W
Aggiornamento: Real-time seguendo mouse
Precisione: 6 decimali (±11 cm)

Uso Pratico

Identificazione Rapida Posizione:
• Muovi mouse su punto di interesse
• Leggi coordinate istantaneamente
• No need per click o geocoding
Export Coordinate:
• Hover su punto
• Leggi coordinate nel tracker
• Scrivi manualmente o screenshot
Verifica Centrali:
• Hover su marker centrale
• Controlla coordinate nel tracker
• Confronta con valori in tabella Centrali

⚠️ Troubleshooting Generale

Problema: Tool Lento
→ Disattiva "Mostra Marker Centrali"
→ Chiudi altre tab browser
→ Usa Chrome/Firefox (no IE/Edge vecchi)

Problema: Mappa Non Si Carica
→ Verifica connessione internet
→ Refresh page (F5)
→ Clear cache browser

Problema: Coordinate Sbagliate
→ Verifica formato: LAT deve essere ~36-47, LON ~6-19 per Italia
→ Se invertiti: swap manualmente
→ Confronta con Google Maps

Problema: Percorso Stradale Non Appare
→ OSRM potrebbe essere temporaneamente offline
→ Attendi 30 sec e riprova
→ Fallback: usa distanza aerea × 1.3 come stima

Problema: Non Trovo Collegamento X
→ Verifica filtri attivi (Area, Zona, Stato, Arco)
→ Click "Reset All" e riprova
→ Cerca per ID numerico invece di nomi

Problema: Select (Azzurro) Non Funziona
→ Verifica di aver selezionato almeno 1 elemento prima
→ Deseleziona tutto e riprova
→ Refresh page se persiste

File Sorgente (Excel)

DB C-FOS:
• C-FOS_x_NAT_[data_release].xlsb — File sorgente principale C-FOS

Fogli rilevanti nel file:
• Nodi: centrali con CLLI, coordinate, zona, area
• Link: collegamenti con IdCavo, SubPath, Arco, TipoSede, Prog_Ramo_Arco, km

Struttura dati integrata in HTML

Arrays esposti globalmente:
• window.NODES — Array nodi C-FOS (centrali)
• window.LINKS — Array collegamenti C-FOS

Campi chiave nei Link C-FOS:
• id: ID collegamento univoco
• from / to: CLLI origine e destinazione
• IdCavo: Identificativo cavo fisico
• SubPath: Sottopercorso
• Arco: Arco di rete
• TipoSedeA / TipoSedeZ: Tipo sede endpoint (1, 2, 3)
• Prog_Ramo_Arco: Progressivo del tratto sull'arco
• km: Distanza in km
• stato: Stato operativo del collegamento

Problemi Comuni e Soluzioni

Problema: Coordinate non valide
→ Verifica formato: LAT 36-47, LON 6-19 per Italia
→ Usa punto decimale, non virgola
→ Rimuovi spazi extra

Problema: CLLI duplicati
→ Ogni CLLI deve essere univoco nel DB
→ Controlla con formula Excel: =COUNTIF(A:A,A2)>1

Problema: Link orfani
→ Verifica che FROM e TO esistano nella lista nodi
→ Case-sensitive: "RMCNTL01" ≠ "rmcntl01"

Problema: JSON malformato
→ Usa validatore JSON online
→ Controlla virgole finali e parentesi
→ Encoding UTF-8 senza BOM

Problema: Mappa vuota dopo update
→ Apri Console Browser (F12)
→ Cerca errori JavaScript rossi
→ Verifica che arrays non siano vuoti

Schema Nodo (Node)

{
  "id": "CENTRALE_001",
  "name": "Milano Centrale",
  "clli": "MLNOITXA",
  "lat": 45.4642,
  "lon": 9.1900,
  "zona": "LO",
  "region": "Lombardia"
}

Schema Collegamento (Link)

{
  "id": "LINK_001",
  "from": "MLNOITXA",
  "to": "RMCNTLXA",
  "distance": 573.2,
  "state": "ATTIVO",
  "zona": "LO",
  "region": "Lombardia",
  "arco": "Dorsale_Nord_Sud"
}